home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / html / src / mpg123.src < prev    next >
Text File  |  1998-03-23  |  3KB  |  65 lines
  1. @@@STARTPACK(mpg123;mpg123 - MPEG audio player)
  2.  
  3. <P>
  4. mpg123 reads one or more files (or standard input  if  ``-''
  5. is  specified)  or  URLs  and plays them on the audio device
  6. (default) or outputs them to stdout.  File/URL is assumed to
  7. be an MPEG-1/2 audio bit stream.
  8. <P>
  9. In addition to reading  MPEG  audio  streams  from  ordinary
  10. files and from the standard input, mpg123 supports retrieval
  11. of MPEG audio files via the HTTP protocol, which is used  in
  12. the  World Wide Web (WWW).  Such files are specified using a
  13. so-called URL (universal resource  location),  which  starts
  14. with  ``http://''.   When a file with that prefix is encountered.
  15. mpg123 attempts to open an  HTTP  connection  to  the
  16. server in order to retrieve that file to decode and play it.
  17. It is often useful to retrieve files through a WWW cache  or
  18. so-called  proxy.   To  accomplish this, mpg123 examines the
  19. environment for variables named  MP3_HTTP_PROXY,  http_proxy
  20. and  HTTP_PROXY,  in this order.  The value of the first one
  21. that is set will be used as proxy specification.   To  override
  22. this,  you can use the -p command line option (see the
  23. ``OPTIONS'' section).  Specifying -p none will enforce 
  24. contacting the server directly without using any proxy, even if
  25. one of the above environment variables is set.   Note  that,
  26. in  order  to play MPEG audio files from a WWW server, it is
  27. necessary that the connection to that server is fast enough.
  28. For  example,  a  128  kbit/s MPEG file requires the network
  29. connection to be at least 128 kbit/s (16 kbyte/s) plus  protocol
  30. overhead.   If you suffer from short network outages,
  31. you should  try  the  -b  option  (buffer)  to  bypass  such
  32. outages.   If  your network connection is generally not fast
  33. enough to retrieve MPEG audio files  in  realtime,  you  can
  34. first  download the files to your local harddisk (e.g. using
  35. lynx(1)) and then play them from there.
  36. <P>
  37. MPEG audio decoding requires a good deal of CPU performance,
  38. especially  layer-3.   To  decode it in realtime, you should
  39. have at least a Pentium,  Alpha,  SuperSparc  or  equivalent
  40. processor.  You can also use the -singlemix option to decode
  41. mono only, which reduces the CPU load somewhat  for  layer-3
  42. streams.   See  also  the  -2 and -4 options.  If everything
  43. else fails, use the -s option to decode to standard  output,
  44. direct it into a file and then use an appropriate utility to
  45. play that file.  You might have to use a tool such as sox(1)
  46. to  convert  the output to an audio format suitable for your
  47. audio player.  Also note that mpg123 always generates 16 bit
  48. stereo  data  (if  one  of the -single* options is used, two
  49. identical stereo channels are generated).  If your  hardware
  50. requires some other format, for example 8 bit mono, you also
  51. have to use a converter such as sox(1).  If your  system  is
  52. generally  fast  enough to decode in realtime, but there are
  53. sometimes periods of heavy system load  (such  as  cronjobs,
  54. users  logging  in  remotely,  starting  of ``big'' programs
  55. etc.) causing the audio output to be interrupted,  then  you
  56. should  use  the  -b option to use a buffer of at least 1000
  57. Kbytes.
  58. </P>
  59.  
  60. @@@UW2DIST(http://www.sco.com/skunkware/uw7/audio/mpg123/)
  61. @@@OSR5DIST(http://www.sco.com/skunkware/osr5/audio/mpg123/)
  62. @@@HOMEPAGE(http://mpg.123.org/)
  63. @@@ENDPACK
  64.  
  65.